Hyper-V-Datacollector-Sheet

Einleitung

Die Einbindung von Hard-/Software – im Folgenden kurz „System" – ins CIO Cockpit erfordert neben der Erfassung im CIO Cockpit die Konfiguration der Datacollection. Die Datensammlung wird zentral über das Datacollection-Management (DCM) eingerichtet.

Kompatibilität

Unterstützte Systemversionen

Es werden Windows-Systeme ab Version 2012 R2 unterstützt.

Voraussetzungen im CIO Cockpit

Für die Einrichtung der Datacollection ist vorab die Anlage aller benötigten Elemente im administrativen Bereich des CIO Cockpit-Web-Frontends durchzuführen:

  1. Alle Nodes des Clusters (inklusive Cluster Node) als Windows-Server anlegen (Konfiguration -> Assets -> Hinzufügen und
    im folgenden Fenster als Asset-Typ Microsoft -> Compute Hardware -> Windows auswählen).
  2. Den Hyper-V-Cluster als VCluster anlegen (Konfiguration -> Virtualisierung -> vCluster -> Hinzufügen) und unter "Speichersystem" alle zugehörigen Nodes (inklusive Cluster-Node) aus dem vorherigen Schritt auswählen.
  3. Einen Hypervisor für den Hyper-V-Cluster anlegen (Konfiguration -> Virtualisierung -> Instanzen -> Hinzufügen) und unter "VCluster" den im vorherigen Schritt angelegten VCluster hinzufügen.

Anschließend kann die Datensammlung für den Hyper-V-Cluster im Datacollection-Mangement konfiguriert werden.

Konfigurationshinweise für das Datacollection-Management

Feldname Erforderlicher Inhalt
IP IP-Adresse der Cluster-Node (z.B. "192.168.178.21")
Username Domain\Username des CIO Cockpit-Users ( z.B. "company\cockpit")
Password Passwort des CIO Cockpit-Users für den Login
Cockpit Reference Der im CIO Cockpit-Webfrontend angelegte Eintrag für den vCluster (wird automatisch eingestellt)
Description Eine Kurzbeschreibung des angelegten Assets (Freitextfeld)
Cluster Hyper-V Betriebsmodus: Cluster oder Standalone Host
Script Output Path UNC-Pfad zur Ausgabe-Datei des PowerShell Scripts (z.B. \output$\cc-output.csv). Node- oder Host-Name werden im Pfad nicht benötigt.

Systemzugriff

Für den Zugriff auf Windows-Hosts via Powershell müssen sowohl die Cluster-Node als auch die Nodes - wie in Konfiguration von Windows-Hosts via Domänencontroller beschrieben - konfiguriert werden. Alle Nodes müssen in der gleichen Domäne wie der Cluster sein.

Systemzugang

Netzwerk und Firewall

Für die Kommunikation des Datacollectors mit dem System sind folgende Einstellungen auf dem Cluster-Node und allen Nodes erforderlich:

Source Destination Port (default) Protocol Direction Comment
datacollector-vm Hyper-V-Cluster-IP 5985 (HTTP) / 5986 (HTTPS) TCP Outbound  

PowerShell Script

Zur Ausführung des entsprechenden Scripts muss dieses als Scheduled Task über einen zusätzlichen Windows-Nutzer angelegt werden. Der Windows-Nutzer benötigt Administrative-Hyper-V Berechtigungen oder Administrator Berechtigungen. Die Logindaten dieses Windows-Nutzers bleiben dem Datacollector unbekannt. Das Script für den Standalone-Betrieb kann hier heruntergeladen werden (Rechtsklick - "Link speichern unter"). Das Script für den Cluster-Betrieb kann hier heruntergeladen werden (Rechtsklick - "Link speichern unter").

Hinweis: Bitte die Scripts nicht umbenennen, da diese in anderen Scripts ebenfalls verwendet werden!

Ordner mit Freigabe Berechtigungen anlegen

Damit der Hyper-V-Datacollector die erzeugte CSV-Datei aus den PowerShell-Scripts abfragen kann, muss der Speicherpfad für diese Ausgabedatei, wie in Erstellung von freigegebenen Ordnern für Windows-Server mit Hyper-V beschrieben, angepasst werden. Der freigegebene Ordner kann als Pfad bei der Erstellung des Datacollectors im DCM angegeben werden. Dafür wird folgendes Schema verwendet: \FREIGEGEBENERORDNER$\AUSGABEDATEI.csv

Ausgabe Pfad im Script anpassen

Im heruntergeladenen Script wird die Variable "$filepath=" zum Dateipfad geändert, welcher im vorherigen Schritt entstanden ist, sowie der Name der Ausgabe-Datei festgelegt. Ein Beispiel hierfür ist "C:\scripts\cc-collector\output\cc-output.csv".

Scheduled Task anlegen

Für die geplante und regelmäßige Ausführung der Scripts muss ein Scheduled Task, wie in Erstellung eines Scheduled Task für Windows-Server mit Hyper-V beschrieben, erstellt und konfiguriert werden.

Automatisierte Konfiguration mittels Script

Über das Konfigurierungs-Script für Hyper-V können die obigen Schritte, nach dem Herunterladen der Hyper-V Scripts, wie in Automatische Konfiguration des Windows-Servers mit Hyper-V beschrieben, automatisiert werden.

KPI-Umfang der Datensammlung

VMInventory

KPI Erläuterung
timestamp Mikrosekundengenauer Zeitstempel des Host-Betriebssystems, auf dem der Datacollector läuft (UTC)
clusterID Die CIO Cockpit-ID des Virtualization Clusters. Sichtbar in der vCluster Übersicht im CIO Cockpit Web-Frontend
vCenterInstanceUUID Die eindeutige ID des Hyper-V-Clusters (oder die MAC-Adresse des Hosts im Standalone Betrieb)
vms Eine Liste der eindeutigen IDs aller VMs innerhalb dieses Clusters

VMUsage

Dieser Datensatz wird pro VM gesammelt.

KPI Erläuterung
timestamp Mikrosekundengenauer Zeitstempel des Host-Betriebssystems, auf dem der Datacollector läuft (UTC)
clusterID Die ID des Virtualization Clusters. Sichtbar in der vCluster Übersicht im CIO Cockpit Web-Frontend
vCenterInstanceUUID Die eindeutige ID des Hyper-V-Clusters (oder die MAC-Adresse des Hosts im Standalone Betrieb)
externalID Die eindeutige ID der VM innerhalb dieses Clusters
name Der vom Nutzer definierte Name der VM
cpuClockProvisioned Die Summe der Taktfrequenzen der zugewiesenen vCPUs
ramProvisioned Der zugewiesene Arbeitsspeicher
storageProvisioned Die zugewiesene Speicherkapazität
threads Die Anzahl zugewiesener vCPUs
powerState „poweredOn“, „poweredOff“
isTemplate false
Liste von Usages siehe unten

Liste von Usages

KPI Erläuterung
storageUsed Die aktuell genutzte Storage-Kapazität (Falls fixed: gleich storageProvisioned)
ramUsed Der aktuell genutzte Arbeitsspeicher
cpuClockUsed Die Summer der aktuell genutzten Taktfrequenzen der zugewiesenen vCPUs
timestamp Mikrosekundengenauer Zeitstempel des Messzeitpunktes für genau diese Usage-Messung (UTC)

hostInventory

KPI Erläuterung
hostName FQDN des Hosts (z.B. myserver23.company.local)
hostType "computeHardware"
Liste von Partitionen kein Inhalt
Liste von Disks kein Inhalt
Liste von RAM-Modulen Datensätze zur Beschreibung des im Hosts verbauten RAM-Modulen (siehe unten)
Liste von CPUs Datensätze zur Beschreibung der im Host verbauten CPUs (siehe unten)

Liste von RAM-Modulen

KPI Erläuterung
ramType Typ des Speichers (z.B. „DRAM“)
ramClock Nominelle Taktfrequenz des RAM-Moduls
ramSize Größe des verbauten RAM-Moduls

Liste von CPUs

KPI Erläuterung
cpuType Vom Hersteller definierter Bezeichner (z.B. „Intel Xeon E5-2609 @ 2.50 GHz“)
cpuThreads Anzahl der Threads der CPU
cpuCores Anzahl der CPU-Kerne in der CPU
cpuClock Die nominelle Taktfrequenz der CPU

hostUsage

KPI Erläuterung
timestamp Mikrosekundengenauer Zeitstempel des Host-Betriebssystems, auf dem der Datacollector läuft (UTC)
hostName FQDN des Hosts (z.B. gibson23.company.local)
cpuClockCapacity Gesamtkapazität der Taktfrequenzen aller Cores aller im Asset verbauten CPUs
ramCapacity Gesamtkapazität aller im Asset verbauten RAM-Module
threads Gesamtanzahl der Threads aller im Asset verbauten CPUs (incl. Hyperthreading)
Liste von Usages Auf dem Host genutzte Ressourcen zum Messzeitpunkt (siehe unten)
uptime* Zeit seit dem letzten Reboot in Sekunden
version Betriebssystem-Version, (z.B. Windows Server 2016)
model Modellbezeichnung des Servers, z.B. „Cisco Systems Inc UCSB-B200-M3"

Liste von Usages

KPI Erläuterung
cpuClockUsed Zu diesem Zeitpunkt genutzte Taktfrequenzen aller Cores aller im Asset verbauten CPUs
ramUsed Zu diesem Zeitpunkt genutzte Speichermenge aller im Asset verbauten RAM-Module
timestamp Mikrosekundengenauer Zeitstempel des Messzeitpunktes für genau diese Usage-Messung (UTC)

clusterUsage

KPI Erläuterung
clusterID Die ID des Virtualization Clusters. Sichtbar in der vCluster Übersicht im CIO Cockpit Web-Frontend
cpuClockCapacity Netto-Computeressourcen des Clusters, die virtuellen Maschinen zur Verfügung stehen. Ergibt sich durch aufsummieren der Taktraten aller verfügbaren CPUs jeweils multipliziert mit der Anzahl der von ihnen zur Verfügung gestellten Threads
ramCapacity Verfügbarer Netto-Arbeitsspeicher des Clusters, der virtuellen Maschinen zur Verfügung steht
usages Liste der auf dem Cluster genutzten Ressourcen zum Messzeitpunkt (siehe unten)
timestamp Mikrosekundengenauer Zeitstempel des Messzeitpunktes (UTC)

Liste von Usages

KPI Erläuterung
cpuClockUsed Nutzung der verfügbaren Computeressourcen zum Messzeitpunkt
ramUsed Nutzung der verfügbaren RAM-Ressourcen zum Messzeitpunkt
timestamp Mikrosekundengenauer Zeitstempel dieses Messzeitpunktes (UTC)

StorageInventory

KPI Erläuterung
assetID Die CIO Cockpit-ID des Assets. Sichtbar in der Assetübersicht des CIO Cockpit Web-Frontends
timestamp Mikrosekundengenauer Zeitstempel des Host-Betriebssystems, auf dem der Datacollector läuft (UTC)
Liste von Disks Alle abzüglich der für das Betriebssystem genutzten Disks des Assets (siehe unten), kategorisiert nach Typ, Kapazität und Anzahl
Liste von Pools Alle Speicherpools dieses Assets.

Liste von Pools

KPI Erläuterung
poolName Name des Pools
Liste von Disks Alle Disks, die diesem Pool zugeordnet sind (siehe unten), kategorisiert nach Typ, Kapazität und Anzahl
Liste von StorageExports Alle Storage-Exporte des Assets

Liste von Disks

KPI Erläuterung
type SAS, NL-SAS, EFD
capacity Gesamtkapazität des gesamten Speichers dieses Disk-Typs
count Anzahl aller Disks mit genau dieser Kombination aus Eigenschaften (type & capacity)

Liste von StorageExports

KPI Erläuterung
uid Eindeutiger Identifier des Exports
sizeCommissioned Exklusiv dem Export zugeteilte, für einen User nutzbare, Speicherkapazität.
sizeUsed Nutzung des Exports auf dem Asset inklusive Overhead.
Nach oben